Risk Signal: Address Validation

Address Validation determines if the address extracted from a government-issued ID (e.g. passport, driver’s license, ID card) exists in the real world. Jumio checks the address against a number of trusted data sources (e.g. USPS, Royal Mail) to properly format and ensure that the address exists in a given jurisdiction.

Supported Credentials

The following values can be uploaded as Prepared Data. Alternatively, they can be extracted by an upstream capability in a workflow.

Key	Type	Mandatory	Description
firstName	string	no	First name of the subject.
middleName	string	no	Middle name of the subject.
lastName	string	no	Last name of the subject.
dateOfBirth	LocalDate	no	Date of birth in yyyy-MM-dd format only
socialSecurityNumber	string	Must include one of: socialSecurityNumber personalNumber idNumber	SSN of the subject.
personalNumber	string	Must include one of: socialSecurityNumber personalNumber idNumber	For Brazil, this will be the CPF number.
address	Object	Yes
address.line1	string	no
address.line2	string	no
address.city	string	Yes	City of residence as it appears on the Id.
address.postalCode	string	Yes	Postal or zip code.
address.subdivision	string	Yes	City subdivision of residence as it appears on the Id.
address.country	string	Yes	Country in ISO-3166-1 Alpha-3 Code or ISO-3166-1 Alpha-2 Code format.
id.idNumber	string	Must include one of: socialSecurityNumber personalNumber idNumber	Primary id number on the identity document.

Example Prepared Data Body

{
    "firstName": "John",
    "middleName": "",
    "lastName": "Smith",
    "dateOfBirth": "1972-11-16",
    "socialSecurityNumber": "123456789",
    "address": {
        "line1": "12345 SW Address Ln",
        "postalCode": "97201",
        "city": "Portland",
        "subdivision": "OR",
        "country": "USA"
    }
}

Response

Response data is available for transactions that include the risk signal. For information on transaction data see Viewing or Retrieving Workflow Transactions.

Example Response

"capabilities": {
   "addressValidation": [{
      "id": "f72b219b-1878-4631-82e3-a16340dfda7a",
      ...
      "decision": {
         "type": "WARNING",
         "details": {
            "label": "ALERT"
         }
       },
       "data": {
          "reasonMessage": "Administrative Area Change, SubAdministrative Area Change,Unknown Street,Locality Partial,Geocoded to Community Level"
       }
   }]

Decision Details Labels

Decision Type	Label	Description
PASSED	OK
REJECTED	DENY
WARNING	ALERT
WARNING	NOT_ENOUGH_DATA
NOT_EXECUTED	UNSUPPORTED_COUNTRY
NOT_EXECUTED	TECHNICAL_ERROR

Data: Reason Messages

Address Validation Messages

Short Description	Long Description
Administrative Area Partial	The address has been partially verified to the Administrative Area (State) Level, which is NOT the highest level possible with the reference data.
Locality Partial	The address has been partially verified to the Locality (City) Level, which is NOT the highest level possible with the reference data.
Thoroughfare Partial	The address has been partially verified to the Thoroughfare (Street) Level, which is NOT the highest level possible with the reference data.
Premise Partial	The address has been partially verified to the Premise (House or Building) Level, which is NOT the highest level possible with the reference data.
Administrative Area Full	The address has been verified to the Administrative Area (State) Level, which is the highest level possible with the reference data.
Locality Full	The address has been verified to the Locality (City) Level, which is the highest level possible with the reference data.
Thoroughfare Full	The address has been verified to the Thoroughfare (Street) Level, which is the highest level possible with the reference data.
Premises Full	The address has been verified to the Premise (House or Building) Level, which is the highest level possible with the reference data.
SubPremises Full	The address has been verified to the SubPremise (Suite) or PO Box Level, which is the highest level possible with the reference data.

Geocode Status Messages

Short Description	Long Description
Geocoded to Street Level	The record was coded to the street level (Zip+4 for US, full postal code for CA).
Geocoded to the Neighborhood Level	The record was geocoded down to neighborhood level (Zip+2 for US).
Geocoded to Community Level	The record was coded to the community level (ZIP centroid for US, 3-digit postal code for CA).
Geocoded to State Level	The record was geocoded to the state (administrative area) level.
Geocoded to Rooftop Level	The record was geocoded down to the rooftop level, meaning the point is within the property boundaries, usually the center.
Geocoded to Interpolated Rooftop Level	The record was geocoded down to the rooftop level using interpolation (educated estimations using street coordinates). The point may be in or close to the property boundaries.

Address Error Messages

Short Description	Long Description
Postal Code Error/General Error	The address could not be verified at least up to the postal code level.
Unknown Street	Could not match the input street to a unique street name. Either no matches or too many matches found.
Component Mismatch Error	The combination of directionals (N, E, SW, etc) and the suffix (AVE, ST, BLVD) is not correct and produced multiple possible matches.
Multiple Match	The address was matched to multiple records. There is not enough information available in the address to break the tie between multiple records.
Sub Premise Number Invalid	An address element after the house number, in most cases the sub-premise, was not valid.
Sub Premise Number Missing	An address element after the house number, in most cases the sub-premise, was missing.
Premise Number Invalid	The premise (house or building) number for the address is not valid.
Premise Number Missing	The premise (house or building) number for the address is missing.
Box Number Invalid	The PO (Post Office Box), RR (Rural Route), or HC (Highway Contract) Box number is invalid.
Box Number Missing	The PO (Post Office Box), RR (Rural Route), or HC (Highway Contract) Box number is missing.
PMB Number Missing	US Only. The address is a Commercial Mail Receiving Agency (CMRA) and the Private Mail Box (PMB or #) number is missing.

Portal View

Open a transaction in the Portal to review the response. The risk signal is labeled Address Validation as shown in the figure below.

Supported Countries

The following countries are supported by Address Validation today. The Address and Geocoding fields are further classified as follows.

Verification Level		GeoCode Level
AV-2	Locality	G-2	Locality
AV-3	Thoroughfare	G-3	Thoroughfare
AV-4	Premises	G-4	Interpolated Rooftop
AV-5	Delivery Point	G-5	Rooftop

Country/Territory Name	ISO2	Region	Address	Geocoding
Aland Islands	AX	WE	AV-4	G-4
Albania	AL	EE	AV-3	G-2
American Samoa	AS	NA	AV-4	G-3
Andorra	AD	WE	AV-4	G-5
Angola	AO	MEA	AV-3	G-4
Argentina	AR	SA	AV-4	G-4
Australia	AU	APA	AV-5	G-5
Austria	AT	WE	AV-5	G-5
Azerbaijan	AZ	EE	AV-4	G-4
Bahamas	BS	CAC	AV-4	G-4
Bahrain	BH	MEA	AV-4	G-4
Bangladesh	BD	ASIA	AV-4	G-4
Belarus	BY	EE	AV-3	G-4
Belgium	BE	WE	AV-4	G-5
Bermuda	BM	CAC	AV-4	G-4
Bosnia and Herzegovina	BA	EE	AV-4	G-5
Botswana	BW	MEA	AV-4	G-4
Brazil	BR	SA	AV-5	G-5
Brunei Darussalam	BN	ASIA	AV-4	G-4
Bulgaria	BG	EE	AV-4	G-5
Canada	CA	NA	AV-5	G-5
Cayman Islands	KY	CAC	AV-4	G-4
Chile	CL	SA	AV-4	G-4
Colombia	CO	SA	AV-4	G-4
Costa Rica	CR	CAC	AV-3	G-3
Croatia	HR	EE	AV-4	G-4
Cyprus	CY	WE	AV-4	G-4
Czech Republic	CZ	EE	AV-4	G-5
Denmark	DK	WE	AV-4	G-5
Ecuador	EC	SA	AV-4	G-4
Egypt	EG	MEA	AV-4	G-5
Estonia	EE	EE	AV-4	G-5
Eswatini	SZ	MEA	AV-3	G-4
Finland	FI	WE	AV-4	G-4
France	FR	WE	AV-5	G-5
French Guiana	GF	SA	AV-4	G-5
Germany	DE	WE	AV-5	G-5
Gibraltar	GI	WE	AV-4	G-4
Greece	GR	WE	AV-4	G-4
Guadeloupe	GP	CAC	AV-4	G-5
Guam	GU	NA	AV-5	G-3
Guatemala	GT	CAC	AV-3	G-4
Guernsey	GG	WE	AV-5	G-4
Hong Kong	HK	ASIA	AV-5	G-4
Hungary	HU	EE	AV-4	G-5
Iceland	IS	WE	AV-4	G-4
India	IN	ASIA	AV-4	G-5
Indonesia	ID	ASIA	AV-4	G-5
Ireland	IE	WE	AV-5	G-4
Isle of Man	IM	WE	AV-5	G-4
Israel	IL	MEA	AV-4	G-5
Italy	IT	WE	AV-4	G-5
Japan	JP	ASIA	AV-5	G-5
Jersey	JE	WE	AV-5	G-4
Jordan	JO	MEA	AV-4	G-4
Kazakhstan	KZ	EE	AV-4	G-5
Korea, Republic of	KR	ASIA	AV-5	G-4
Kuwait	KW	MEA	AV-3	G-3
Latvia	LV	EE	AV-4
Lebanon	LB	MEA	AV-4	G-4
Liechtenstein	LI	WE	AV-4	G-5
Lithuania	LT	EE	AV-4	G-4
Luxembourg	LU	WE	AV-4	G-5
Macao	MO	ASIA	AV-4	G-4
Macedonia	MK	EE	AV-4	G-5
Malaysia	MY	ASIA	AV-4	G-5
Malta	MT	WE	AV-4	G-5
Marshall Islands	MH	NA	AV-4	G-3
Martinique	MQ	CAC	AV-4	G-5
Mayotte	YT	MEA	AV-4	G-5
Mexico	MX	NA	AV-4	G-4
Micronesia	FM	NA	AV-4	G-3
Monaco	MC	WE	AV-4	G-5
Montenegro	ME	EE	AV-4	G-4
Morocco	MA	MEA	AV-4	G-4
Mozambique	MZ	MEA	AV-3	G-4
Namibia	NA	MEA	AV-4	G-4
Netherlands	NL	WE	AV-5	G-5
New Zealand	NZ	APA	AV-4	G-4
Nigeria	NG	MEA	AV-3	G-4
Northern Mariana Islands	MP	NA	AV-4	G-4
Norway	NO	WE	AV-4	G-4
Oman	OM	MEA	AV-4	G-4
Palau	PW	NA	AV-4	G-3
Panama	PA	CAC	AV-4	G-5
Paraguay	PY	SA	AV-4	G-4
Peru	PE	SA	AV-4	G-4
Philippines	PH	ASIA	AV-4	G-4
Poland	PL	EE	AV-4	G-5
Portugal	PT	WE	AV-4	G-4
Puerto Rico	PR	NA	AV-5	G-3
Qatar	QA	MEA	AV-4	G-4
Réunion	RE	MEA	AV-4	G-5
Romania	RO	EE	AV-4	G-5
Russia	RU	EE	AV-5	G-5
Saint Barthélemy	BL	CAC	AV-2	G-4
Saint Pierre and Miquelon	PM	NA	AV-4	G-5
San Marino	SM	WE	AV-4	G-4
Saudi Arabia	SA	MEA	AV-4	G-5
Serbia	RS	EE	AV-4
Singapore	SG	ASIA	AV-4	G-5
Slovakia	SK	EE	AV-4	G-5
Slovenia	SI	EE	AV-4	G-4
South Africa	ZA	MEA	AV-4	G-5
Spain	ES	WE	AV-4	G-5
Sri Lanka	LK	ASIA	AV-3	G-4
Suriname	SR	SA	AV-4	G-4
Sweden	SE	WE	AV-4	G-4
Switzerland	CH	WE	AV-4	G-4
Taiwan	TW	ASIA	AV-4	G-5
Thailand	TH	ASIA	AV-4	G-5
Tunisia	TN	MEA	AV-4	G-4
Turkey	TR	EE	AV-4	G-5
Ukraine	UA	EE	AV-4	G-5
United Arab Emirates	AE	MEA	AV-4	G-4
United Kingdom	GB	WE	AV-5	G-5
United States of America	US	NA	AV-5	G-5
United States Virgin Islands	VI	NA	AV-5	G-3
Uruguay	UY	SA	AV-4	G-4
Vietnam	VN	ASIA	AV-4	G-5
Zimbabwe	ZW	MEA	AV-4	G-4